Libris Britannia 4

home *** CD-ROM | disk | FTP | other *** search

/ Libris Britannia 4 / science library(b).zip / science library(b) / SCIENTIF / H558.ZIP / QDG206.ZIP / QDIGIT.HLP < prev next >

Wrap

Text File | 1994-02-07 | 19KB | 544 lines

███████ ███████ ███ ██████ ███ ███████ █░░░░░█░ █░░░░█░ █░░ █░░░░█░ █░░ █░░█░░█░ █░ █░ █░ █░ █░ █░ ░ █░ ░ █░ ░ █░ █░ █░ █░ █░ █░ ███ █░ █░ █░ █░ █░ █░ █░ █░ █░░ █░ █░ █░ █ █░ █░ █░ █░ █░ █░ █░ █░ ███████░ ███████░ ███ ██████░ ███ ███ ░░░░█░░ ░░░░░░░ ░░░ ░░░░░░ ░░░ ░░░ █ ░ Copyright (C) 1992-94 P.C. Jahans An easy-to-use program for digitizing geological contacts and structures, outcrops, contours, etc. Output is placed in ASCII files which can be viewed on screen or sent to a printer. QDigit is completely menu-driven and features context- sensitive help -- there is no need for a manual. Just press <F1> at any time for relevent information. You may, however, need to refer to your digitizer manual to correctly configure QDigit before use. Other features include full mouse support (although a mouse is not necessary), high speed data capture, and automatic saving of your configuration setup and calibration parameters. QDigit uses an affine transform to convert between map (world) and digitizer coordinates producing accurate results even from distorted maps or cross-sections (those which are not quite rectangular but more like irregular quadrilaterals). Such maps can result when the paper they are printed on is handled, folded, or soaked by rain. QDigit may be freely distributed and you are encouraged to do so. Individuals, students and educational institutions may licence one copy free of charge. If more than one copy is required, or if the program is used in a professional or commercial environment, a fee payment is required after a 30- day trial period as follows: Individuals, educational institutions: Free for the first copy $25 for extra copies Industry: $50 for the first copy $25 for additional copies Payment may be made in US or Canadian dollars in the form of a cheque or money order addressed to the author at the address below. Please do not send cash. Bug reports, suggestions are welcome. Peter C. Jahans Department of Geology University of Alberta Edmonton, Alberta T6G 2E3 Copyright (C) 1992, 1993, 1994 P.C. Jahans All rights reserved. 1023 hcHistList = $03FF; History Lists▐ ▀▀▀▀▀▀▀▀▀▀▀▀▀ This is a list of previous choices in this category. You may select from this list as a shortcut to typing in the selection again. This feature is most useful when similar data is used repeatedly. Hit the <Enter> key to accept a highlighted selection or double-click on it with the mouse cursor. To cancel, click on the close button (upper left corner) or hit <Esc> to close history window. 1296 hcFileView = $0510; File Viewer▐ ▀▀▀▀▀▀▀▀▀▀▀ You can view any text file in a scrolling window, and may view more than one file at a time by selecting this option repeatedly. Only the first 64k bytes or so of a file can be displayed in the viewer. 1312 hcFilePrint = $0520; File Printing▐ ▀▀▀▀▀▀▀▀▀▀▀▀▀ Files can be sent to the printer using this option. The printer port is configured under Settings/Printer. 1344 hcDosShell = $0540; DOS Shell▐ ▀▀▀▀▀▀▀▀▀ You may temporarily suspend QDigit to execute DOS commands and return to exactly where you left. To return, just type EXIT at the DOS prompt. 1360 hcTile = $0550; Window Tiling▐ ▀▀▀▀▀▀▀▀▀▀▀▀▀ When multiple file viewing windows are on the screen, they may be tiled for simultaneous viewing. Each window is sized so that altogether they fill the area of the screen's "desktop". 1376 hcCascade = $0560; Window Cascading▐ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ When multiple file viewing windows are on the screen, they may be cascaded or stacked like a deck of cards for individual viewing, leaving only the top and left frame segments of the covered windows visible. By clicking the mouse cursor on the frame top, or using the function keys, windows may be brought to the top of the stack and moved around the screen. 1536 hcStartSubMenus = $0600; Select this option to view a sub-menu list. 1945 hcBanner = $0799; Billboard▐ ▀▀▀▀▀▀▀▀▀ Introductory banner with author name and copyright notice. 2201 hcHelp = $0899; Help▐ ▀▀▀▀ Use the <F1> hot-key to obtain context sensitive help at any time. The help system always knows which part of the program is in use and brings up appropriate information to assist the user. 2457 hcQuit = $0999; Terminate Program▐ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Exit QDigit. You can also exit quickly using the hot-key combination: <Alt X> 4368 hcComSettings = $1110; Communications▐ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀ These communications protocols must be set so that the digitizer can "talk" to the computer properly. Choose the COM port which is connected to the digitizer and set the other parameters according to your digitizer's manual. For example, a Summagraphics tablet typically requires the following setup: Baud Rate -- 9600 Parity -- EVEN Data Bits -- 7 Stop Bits -- 2 4384 hcSetDataType = $1120; Data Format▐ ▀▀▀▀▀▀▀▀▀▀▀ This is the format of the signals sent from your digitizer to the computer. Consult your digitizer's manual to determine which format is used. If your digitizing tablet outputs data using ASCII format make certain of the positions of characters and lengths of numeric fields. For example, a Summagraphics tablet typically uses an ASCII format as follows: Button Position -- 2 X Coordinate Starting Position -- 3, Length -- 6 Y Coordinate Starting Position -- 9, Length -- 6 4400 hcCalibrate = $1130; Calibrate Map▐ ▀▀▀▀▀▀▀▀▀▀▀▀▀ The digitizer needs to be calibrated to the coordinates of your map (world coordinates) before digitizing commences. Select X, Y or longitude/latitude coordinates then digitize four known points on your map. Units do not matter, just enter the known values when QDigit requests. Geographic coordinates are displayed in the order longitude, latitude. When calibration is complete, all coordinates are displayed as map (world) coordinates. You may optionally calibrate north for use when digitizing outcrops. 4432 hcCalibrateN = $1150; Calibrate North▐ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ When digitizing outcrops, the true direction of north must be provided so that dip directions may be accurately calcula- ted. First digitize a point near the northern end of a line parallel to north, then digitize a point near the southern end. This calibration is not necessary if outcrops will not be digitized. 4448 hcSetParaPort = $1160; Printer Port▐ ▀▀▀▀▀▀▀▀▀▀▀▀ Indicate the port to which printer is attached. 4464 hcReadDefaults = $1170; Load a Configuration File▐ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Upon startup, QDigit first looks for the default config- uration file (usually QDIGIT.DEF) in the current directory. If one isn't found there, the directory in which QDigit resides is then searched. If a configuration file is found, parameters specifying calibration values, I/O ports used, communication settings, etc., stored in the file will be automatically used to configure QDigit. Any configuration file, including those created using the Setup/Save Setup menu option, may also be loaded at any time. This can be very useful for digitizing several small maps or logs at one time, and also if an error was made while reconfiguring some parameter and the original value was lost. The command-line option, /C <filename>, where <filename> is the name of a default configuration file (without the angle brackets), allows the automatic loading of a user-specified configuration at program startup. 4480 hcSaveDefaults = $1180; Save a Configuration File▐ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Selecting this option will manually save your current setup information such calibration values, communications settings ports in use, etc., in a file chosen by the user. Although these items are saved automatically when the QDigit is terminated, manually saving a configuration is recommended after calibration or setup and especially before altering any parameters for which the consequences are unknown. Your saved configuration can be reloaded at any time using the Setup/Load Setup menu option. 4496 hcResetDefaults = $1190; Reset Configuration▐ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Selectively reset configuration parameters to system defaults. Resetting calibration allows the use of digitizer coordinates instead of map coordinates. If any "Advanced" configuration parameters are reset (such as communication settings and/or data format) you may have to refer to your digitizer manual to reconfigure the program. If you reset the advanced parameters and immediately save your setup, the configuration file will likely contain improper information upon subsequent startups but QDigit will not give a warning. 4512 hcSetPrecision = $11A0; Set Output Data Precision▐ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ The start of each line of data output by the digitizer is either a map coordinate pair or the depth and value of a log. The representation of these data are visible at the top left corner of the screen. You can alter the way these data appear on the screen and in the output file by setting the WIDTH and PRECISION parameters. WIDTH must be between 1 and 12, and PRECISION must be between 0 and WIDTH-2. These settings should also match the values of the actual data or output representation may be unpredictable or incorrect. For instance, don't specify a width of 4 to display coordinate values like 6543117.50. Examples: 334.2837 results from WIDTH = 8, PRECISION = 4 334.3 results from WIDTH = 5, PRECISION = 1 4608 hcNotInitialized = $1200; Program Not Initialized▐ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Upon startup, QDigit first looks for the default config- uration file (usually QDIGIT.DEF) in the current directory. If one isn't found there, the directory in which QDigit resides is then searched. If still no file is found and none was specified on the command line using the /C <filename> option, QDigit starts up in an uninitialized state and must be configured to your digitizer using the Setup/Advanced/Comm Settings and Setup/Advanced/Data Format menu options. You may need to refer to your digitizer manual to correctly configure QDigit before use. 4624 hcDigitizePoints = $1210; Digitizing Points▐ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ This is a generic point digitizing procedure. Only X, Y or lon/lat coordinates will be saved in the output file. 4640 hcDigitizeLines = $1220; Digitizing Lines▐ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ This is a generic line digitizing procedure. Only X, Y or lon/lat coordinates will be saved in the output file. 4656 hcDigitizeWells = $1230; Digitizing Wells▐ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ X, Y or lon/lat coordinates plus any additional specified information (kb elevation, well name, total depth, etc.) will be saved in the output file. This option can of course also be used to store any kind of data pertaining to digitized point coordinates. 4672 hcDigitizeCntrs = $1240; Digitizing Contours▐ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ X, Y or lon/lat coordinates of lines and the corresponding specified constant elevation will be saved in the output file. 4688 hcDigitizeOCrops = $1250; Digitizing Outcrops▐ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ X, Y or lon/lat coordinates and dip direction will be calculated for each digitized outcrop. These data plus additional information such as dip, elevation, etc. will be saved in the output file. 4704 hcPositionOCrops = $1260; Positioning Outcrops▐ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Use the digitizer to find the precise coordinates of an outcrop as you draft them onto a map. X, Y or lon/lat coordinates plus any additional specified information (elevation, dip direction & dip, etc.) will be saved in the output file. 8192 hcOkBox = $2000; Dialog Box▐ ▀▀▀▀▀▀▀▀▀▀ This window is known as a dialog box. It may contain input controls such as editing fields, check-boxes and radio buttons. Editing fields are used to type in appropriate text, checkboxes for selecting one or more options and radio buttons for choosing one unique option. There is full mouse and/or keyboard support. Hit Ok or the <F9> key to accept what is displayed, Cancel or the <Esc> key to abort. Any highlighted text in an input field is immediately replaced by most keystrokes. The exceptions are when an arrow key or the insert or backspaces are pressed. 8208 hcFileListBox = $2010; File List Window▐ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Select from the list, or type into the input field the name of the file desired. When the cursor resides in the list, typing the first letters of the filename will cause the cursor to jump to the first names starting with those letters. File information is shown at the bottom of the window. 8224 hcMessageBox = $2020; Message Window▐ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀ You may respond to the message contained in this window by clicking on a button or you may cancel and remove the window by hitting the <Esc> key. 8448 hcCalibrateBox = $2100; The digitizer is waiting for your actions here: press the digitizer mouse button to register points. To backtrack or abort, click on the close button (upper left corner of the window), or hit the <Esc> key. 8464 hcCalibrateNBox = $2110; The digitizer is waiting for your actions here: press the digitizer mouse button to register points. To backtrack or abort, click on the close button (upper left corner of the window), or hit the <Esc> key. 8704 hcDigWindow = $2200; The digitizer is waiting for your actions here: press the digitizer mouse button to register points. To indicate when you are finished, click on the close button (upper left corner of the window), or hit the <F3> or the <Esc> key. 8720 hcPointDigWindow = $2210; The digitizer is waiting for your actions here: press the digitizer mouse button to register points. To indicate when you are finished, click on the close button (upper left corner of the window), or hit the <F3> or the <Esc> key. 8736 hcLineDigWindow = $2220; The digitizer is waiting for your actions here: press the digitizer mouse button to register points. To indicate when you are finished, click on the close button (upper left corner of the window), or hit the <F3> or the <Esc> key. 8752 hcWellDigWindow = $2230; The digitizer is waiting for your actions here: press the digitizer mouse button to register points. To indicate when you are finished, click on the close button (upper left corner of the window), or hit the <F3> or the <Esc> key. 8768 hcCntrDigWindow = $2240; The digitizer is waiting for your actions here: press the digitizer mouse button to register points. To indicate when you are finished, click on the close button (upper left corner of the window), or hit the <F3> or the <Esc> key. 8784 hcOCDigWindow = $2250; The digitizer is waiting for your actions here: press the digitizer mouse button to register points. To indicate when you are finished, click on the close button (upper left corner of the window), or hit the <F3> or the <Esc> key. 8800 hcOCPosWindow = $2260; The digitizer is waiting for your actions here: press the digitizer mouse button to register points. To indicate when you are finished, click on the close button (upper left corner of the window), or hit the <F3> or the <Esc> key. 8816 hcCntrDatWindow = $2270; Elevation Data▐ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Enter the elevation value for the contour you are about to digitize. This value will be saved with every X, Y or lon/lat coordinate in the specified file. 8992 hcFileViewer = $2320; File Viewing Window▐ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ This window displays the file you select for viewing. It can be scrolled up or down and left or right if required, can be moved, zoomed and resized, and cascaded or tiled with other viewing windows. Either the mouse or the keyboard can facili- tate these tasks -- check the status line for command hints. To move the window via the keyboard, hit <Ctrl F5> then the arrow keys, or, using the mouse, click and hold on the top border of the window and drag it. To resize the window via the keyboard, hit <Ctrl F5> as before, then use the shifted arrow keys, or, with the mouse, click on the lower right corner of the window and drag it.